home *** CD-ROM | disk | FTP | other *** search
/ Over 1,000 Windows 95 Programs / Over 1000 Windows 95 Programs (Microforum) (Disc 1).iso / 0841 / readme.txt next >
Text File  |  1997-04-11  |  6KB  |  158 lines
  1.  
  2.  
  3.  Hi! Thanks for downloading Winph.
  4.  
  5. First, the legal stuff. Niether I, Mark Notarus, nor the University of
  6. Illinois Board of Trustees make any warrantee about the suitability,
  7. stability, or functionality of this program. Therefore, we are not at
  8. all responsible for any damages, consequential or incidental, and by
  9. running this program, you are agreeing not to hold either of the above
  10. responsible for any problems whatsoever.
  11.  
  12.  This program is released as freeware. Feel free to use it. If you
  13. distribute the program, you must distribute it as this archive.
  14.  
  15.  
  16.  
  17.  
  18. What:
  19.  
  20.  Winph is a Windows Sockets CCSO PH (phone book) client, which provides
  21. the ability to look up entries in a CCSO PH server. It is a 32bit program, 
  22. and runs nicely under windows 95 and windows NT. If you want to use it under
  23. Windows 3.x or Win for Workgroups, you will need to install win32s. Win32s can
  24. be downloaded from ftp://pub/www/ncsa/Mosaic/Windows/Win31x/Win32s/ .
  25.  
  26.  Winph also requires a Windows Sockets V1.1 implementation. This includes 
  27. Trumpet Winsock, any Microsoft TCP/IP implementation, and FTP Software's 
  28. Onnet/PCTCP products. I haven't tested anything else, yet.
  29.  
  30.  The WINPH15.EXE file is pretty big, 500k or so. It's like this because
  31. I decided to roll all the runtime libraries into the file, rather than require
  32. a bunch of external DLL files and stuff. If you have WINPH15.EXE, and a working
  33. winsock stack, you can PH people. 
  34.  
  35. Installing:
  36. There's almost no installation required-- put it in a directory, and run it. 
  37.  
  38. How:
  39.  
  40.  To use, double click the WinPh icon in your start menu or program manager.
  41. The default server is the University of Illinois, Urbana-Champaign's PH
  42. server. Enter the name of the person you want to look up. Wild cards are ok,
  43. but some servers put time limits on the lookup, so the more you spell out,
  44. the better the chance of success. An example lookup is to set your server to
  45. UIUC (the default), and enter "john smith" as your query. You should get a
  46. number of entries for different John Smiths.  
  47.  
  48.  If you want to PH someone using a different server, pull down the File menu,
  49. and select Preferences. Click on the Get Server List button to download
  50. the latest server list from the UIUC server. Then, choose your server from
  51. the pull down list. This server list is cached in the INI file, and read in
  52. when you open the preferences dialog, so you might experience a slight pause
  53. while WINPH loads this list. An alternative is to just type in the IP Address
  54. of a PH server in the top text box in the window ("Enter Server Name"). 
  55. FQDN or actual dotted IP address is fine here.
  56.  
  57. Unfortunately, I haven't found a guaranteed way to pull a server list from 
  58. all PH servers, so, the only server you can get a server list from, right now, 
  59. is UIUC. Sorry about that.
  60.  
  61. You can change the font used in the output window, and the input window. If you
  62. uncheck the box labeled "Apply changes to both windows", then font changes 
  63. apply to only the output window by default.
  64.  
  65.   If you select the "Changes apply only to this session" box, then changes
  66. only apply to this session. If not, they're saved to the config file
  67. so that they are your defaults the next time. 
  68.  
  69.    If the config file (c:\<windows dir>\winph.ini) has the key "neversave" 
  70. in the section "WinPh" set to any value, then this check box is always on,
  71. and also is disabled. This allows the program to run in a lab enviornment
  72. and let the users make changes while leaving the defaults correct for
  73. the next user. 
  74.  
  75.  Also, you can change the default timeout in the ini file. This timeout
  76. controls how long WINPH waits for a reply from the remote server. The default is 
  77. 20 seconds. If you're on a slow link, you might want to add the line 
  78. "timeout=60" (60 seconds) in the ini file, under the section WINPH.
  79.  
  80.  
  81. Error Handling:
  82.  
  83.  Errors are handled pretty gracefully, I think. If you get a "server not found"
  84. message, it means that WINPH can't find your server's IP address. This is usually
  85. caused by a typo, or because your DNS can't find the name
  86.  
  87.  "Can't connect to host" means that WINPH can't reach the remote host.
  88.  
  89.  "Timeout" means one of two things: A, the host didn't send any data back in
  90. 20 seconds (or whatever you set your timeout to), or B, you exceeded your
  91. CPU limit on a ph query that included wildcards.
  92.  
  93. Oh, and when you get the current server list, University of Illinois at
  94. Urbana-Champaign will show up twice. It's not a bug (well, my bug,
  95. anyway!), but UofI's PH server lists itself twice. 
  96.  
  97.  
  98. Contacting the Author:
  99.  
  100.  
  101.  Please mail bug reports, comments, or suggestions to notarus@uiuc.edu. It
  102. would be a good idea to put WinPh in the subject somewhere. If you're mailing
  103. a bug report, please include the following information:
  104.  
  105.   1. What version of windows you are using, and of the program. (About box)
  106.   2. What TCP/IP stack you are using. 
  107.   3. If it's an error you get while atttempting to connect to a server,
  108.      include the server name. 
  109.   4. If it's an error you only get while ph'ing a particular person (or set
  110.      of..) include the PH command, too.
  111.   5. Last, please don't forget to describe the error! :)
  112.  
  113.  
  114.  Thanks for using this. I hope it's useful to you!
  115.  
  116.  Mark Notarus
  117.  notarus@uiuc.edu
  118.  
  119.  
  120.  
  121.  
  122. Known Problems:
  123.  
  124. None, as of yet.
  125.  
  126.  
  127.  
  128. Version history:
  129.  1.5:   Oct 31, 1996
  130.     Totally rewritten in C, and talks directly to Winsock. Appears to have
  131.         licked the font problem. Lots of new features.
  132.     WINPH now caches the server list on your hard drive, so you don't need
  133.             to download it often.
  134.     You can now easily enter the address of a server that's not in the
  135.         list.
  136.     You can change the font of both the input and output windows.
  137.     WINPH indicates which server it's talking to in the title bar.
  138.     FAST! 10-12x faster. C++ rules over Visual Basic speedwise.
  139.  1.0.7: July 26, 1996 
  140.           Fixed typo that prevented you from actually changing servers. 
  141.  1.0.6: July 12, 1996
  142.           Fixed problem with 16bit font objects. For real, this time, i hope. 
  143.  1.0.5: Fixed font bug, which prevented some people (and me!) from selecting
  144.         certain fonts (Lucida Console, fe)
  145.  
  146.         Fixed problem with displaying data recieved from very slow servers.
  147.  
  148.         Optimized a few internal things.
  149.  
  150.         Fixed size of the 16 bit distribution.
  151.  
  152.  
  153.  1.0.4: Released to the world
  154.  
  155.  1.0: First release. Test release at UofI campus.
  156.   
  157.  
  158.